Github envs Delete Edit

Oversikt over alle 12 tilgjengelige contexts i GitHub Actions-workflows, med eksempel på output. En context er et objekt du leser verdier fra med ${{ ... }}-syntaks, f.eks. ${{ github.sha }}.

Noen contexts (som github og runner) er tilgjengelige overalt i en workflow, mens andre (matrix, needs, inputs) bare finnes når workflowen faktisk bruker den funksjonen.

Oversikt

github

Den mest brukte contexten. Inneholder informasjon om repoet, commiten, hendelsen som trigget workflowen, og selve kjøringen.

- name: Vis commit-info
  run: |
    echo "SHA: ${{ github.sha }}"
    echo "Branch: ${{ github.ref_name }}"
    echo "Trigget av: ${{ github.actor }}"

Output:

SHA: ffac537e6cbbf934b08745a378932722df287a5
Branch: main
Trigget av: geira

env

Variabler du selv har definert med env: på workflow-, job- eller step-nivå. Brukes til å lese egne variabler i uttrykk (ikke i selve shell-scriptet, der brukes $NAVN direkte).

env:
  NODE_ENV: production

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Vis miljø
        run: echo "Kjører i ${{ env.NODE_ENV }}"

Output:

Kjører i production

vars

Konfigurasjonsvariabler satt i repo-, organisasjons- eller miljøinnstillingene på GitHub (Settings → Secrets and variables → Actions → Variables). I motsetning til env er disse ikke hardkodet i workflow-filen, og i motsetning til secrets er de ikke maskert i loggen.

- name: Vis deploy-miljø
  run: echo "Deployer til ${{ vars.DEPLOY_ENV }}"

Output:

Deployer til staging

job

Informasjon om jobben som kjører akkurat nå – status, container og service-containere.

- name: Sjekk status
  if: always()
  run: echo "Jobbstatus: ${{ job.status }}"

Output:

Jobbstatus: success

jobs

Brukes inni en reusable workflow (workflow_call) for å definere hvilke outputs workflowen skal eksponere til den som kaller den. Ikke å forveksle med needs, som brukes i den kallende workflowen.

# I selve den gjenbrukbare workflow-filen:
on:
  workflow_call:
    outputs:
      build-id:
        value: ${{ jobs.build.outputs.build-id }}

jobs:
  build:
    outputs:
      build-id: ${{ steps.set-id.outputs.id }}
    steps:
      - id: set-id
        run: echo "id=bygg-1234" >> "$GITHUB_OUTPUT"

Output (som annen workflow leser):

build-id: bygg-1234

steps

Gir tilgang til outputs og resultat fra tidligere steps i samme job. Krever at steget har en id.

- name: Hent versjon
  id: version
  run: echo "tag=v1.4.2" >> "$GITHUB_OUTPUT"

- name: Bruk versjonen
  run: echo "Bygger versjon ${{ steps.version.outputs.tag }}"

Output:

Bygger versjon v1.4.2

runner

Informasjon om maskinen (runneren) som utfører jobben.

- name: Vis runner-info
  run: echo "${{ runner.os }} / ${{ runner.arch }}"

Output:

Linux / X64

secrets

Secrets tilgjengelig for kjøringen, inkludert det automatisk genererte GITHUB_TOKEN og egendefinerte secrets. GitHub maskerer alltid verdien i loggen.

- name: Logg inn
  run: echo "Bruker token ${{ secrets.GITHUB_TOKEN }}"

- name: Bruk eget secret
  run: deploy --key "${{ secrets.DEPLOY_KEY }}"

Output:

Bruker token ***

strategy

Detaljer om matrise-strategien til jobben – hvor mange jobber, hvilken posisjon denne jobben har, og innstillinger for parallellitet.

- name: Vis matrise-posisjon
  run: echo "Jobb ${{ strategy.job-index }} av ${{ strategy.job-total }}"

Output:

Jobb 1 av 3

matrix

De konkrete matrise-verdiene som gjelder for akkurat denne jobb-instansen.

jobs:
  test:
    strategy:
      matrix:
        node-version: [18.x, 20.x, 22.x]
    runs-on: ubuntu-latest
    steps:
      - name: Vis Node-versjon
        run: echo "Tester med Node ${{ matrix.node-version }}"

Output (én av tre jobber):

Tester med Node 20.x

needs

Gir tilgang til resultat og outputs fra jobber denne jobben har erklært som avhengighet med needs:.

jobs:
  build:
    runs-on: ubuntu-latest
    outputs:
      artifact-name: ${{ steps.build.outputs.name }}
    steps:
      - id: build
        run: echo "name=app-build-1234" >> "$GITHUB_OUTPUT"

  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Deploy artefakt
        run: echo "Deployer ${{ needs.build.outputs.artifact-name }}"

Output:

Deployer app-build-1234

inputs

Input-verdier gitt til en gjenbrukbar workflow (workflow_call) eller til en manuelt trigget workflow (workflow_dispatch).

on:
  workflow_dispatch:
    inputs:
      environment:
        description: "Miljø å deploye til"
        default: "staging"
        type: string

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Vis valgt miljø
        run: echo "Deployer til ${{ inputs.environment }}"

Output (hvis “production” ble valgt manuelt):

Deployer til production

Kilder

• https://docs.github.com/en/actions/reference/workflows-and-actions/contexts
• https://docs.github.com/en/actions/learn-github-actions/contexts